package com.example.service;

import com.example.entity.QRCode;

import java.util.List;

/**
 * 二维码服务接口
 */
public interface QRCodeService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    QRCode queryById(Long id);

    /**
     * 查询多条数据
     *
     * @param offset 查询起始位置
     * @param limit  查询条数
     * @return 对象列表
     */
    List<QRCode> queryAllByLimit(int offset, int limit);

    /**
     * 查询所有二维码
     *
     * @param qrCode 筛选条件
     * @return 二维码列表
     */
    List<QRCode> queryAll(QRCode qrCode);
    
    /**
     * 查询用户的二维码列表
     *
     * @param userId 用户ID
     * @param offset 查询起始位置
     * @param limit  查询条数
     * @return 对象列表
     */
    List<QRCode> queryByUserId(Long userId, int offset, int limit);
    
    /**
     * 统计二维码总数
     * 
     * @return 二维码总数
     */
    Integer countQRCodes();
    
    /**
     * 统计用户的二维码总数
     * 
     * @param userId 用户ID
     * @return 二维码总数
     */
    Integer countUserQRCodes(Long userId);

    /**
     * 新增数据
     *
     * @param qrCode 实例对象
     * @return 实例对象
     */
    QRCode insert(QRCode qrCode);

    /**
     * 修改数据
     *
     * @param qrCode 实例对象
     * @return 实例对象
     */
    QRCode update(QRCode qrCode);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Long id);
    
    /**
     * 生成二维码图片
     *
     * @param content 二维码内容
     * @param width   宽度
     * @param height  高度
     * @return Base64编码的图片数据
     */
    String generateQRCodeImage(String content, int width, int height);
    
    /**
     * 保存二维码图片
     *
     * @param qrCode  二维码对象
     * @param base64Image Base64编码的图片数据
     * @return 图片保存路径
     */
    String saveQRCodeImage(QRCode qrCode, String base64Image);
}